schm-wms-sap-eapi

Interface Description: Data transmission of various business operations between WMS and SAP is accomplished through the Mulesoft interface.

WMS Call:

UAT Address (Test Environment): https://schm-api-test.shiseido.cn/schm-wms-sap-eapi
PROD address (production environment): https://schm-api.shiseido.cn/schm-wms-sap-eapi

SAP Call：

UAT Address (Test Environment): https://schm-api-test.shiseido.cn/schm-sap-wms-eapi
PROD address (production environment): https://schm-api.shiseido.cn/schm-sap-wms-eapi

1.Identity verification

All request headers must contain the following key-value parameters as the authentication information. You need to apply for these details from the administrator.

client_id: fa98****3452
client_secret: 108b****41f2

2.Interface Overview:

User of the interface:WMS

User of the interface:SAP

The complete invocation address is the corresponding environment address plus the interface address. For example, if the test environment invokes the outboundDeliveryPGI to transmit the 4063 data content, then the interface invocation address would be:
https://schm-api-test.shiseido.cn/schm-wms-sap-eapi/outboundDeliveryPGI

3.Interface Call Instructions

3.1 WMS to SAP: Purchasing (transfer from warehouse) 4061 Inbound GR confirmation

Request Interface: /inboundGRConfirmation
Interface Description: WMS Purchasing (transfer from warehouse)
Request Type HTTP POST

Request Parameter Description

Request Parameter Example

{
  "MT_SCH_WMS_InboundGRConfirmation": {
    "FileName": "4000004061_7855_20221221111505320_2104.xml",
    "IBDGR": {
      "BUDAT": "20221221",
      "GM_CODE": "01",
      "Item": [{
        "VBELN": "4100642547",
        "COSNR": "000010",
        "MATNR": "10116152801",
        "WERKS": "7855",
        "LGORT": "W007",
        "ERFMG": "1002",
        "ERFME": "EA",
        "CHARG": "COMMON",
        "EXPIRYDATE": null,
        "PRODDATE": null,
        "MOVETYPE": "109",
        "STOCKTYPE": null,
        "MOVEFLG": "B",
        "BELNR": "4570014383",
        "VGPOS": "00010"
      }]
    }
  }
}

3.2 WMS to SAP: Withdrawal (removal from the warehouse) 4063 Outbound Delivery PGI

Request Interface: /outboundDeliveryPGI
Interface Description: WMS Withdrawal (removal from the warehouse)
Request Type HTTP POST

Request Parameter Description

Request Parameter Example

{
  "MT_SCH_WMS_OutboundDeliveryPGI": {
    "FileName": "4000004063_7855_20220701132305570.xml",
    "OBDPGI": {
      "VBELN": "4500019792",
      "ISDD": "20220627",
      "QualifierDate": "006",
      "QualifiePGI": "PGI",
      "QualifiePIC": "PIC",
      "QualifieCHG": "CHG",
      "Item": [{
        "POSNR": "000010",
        "MATNR": "10103954202CN",
        "CHARG": "2622AA",
        "WERKS": "7855",
        "AdmQnty": "10",
        "LGORT": "W001",
        "MEINS": "EA",
        "HIPOS": "0",
        "Controlling": {
          "QualifierType": "QUA"
        }
      }]
    }
  }
}

3.3 WMS to SAP: Internal storage 4053 Stock movements

Request Interface: /stockMovementIn
Interface Description: WMS Internal storage
Request Type HTTP POST

Request Parameter Description

Request Parameter Example

{
  "MT_SCH_WMS_StockMovementInbound": {
    "FileName": "4000004053_7855_20221219161001040_2099.xml",
    "DocHead": {
      "BLDAT": "20221219",
      "BUDAT": "20221219",
      "XBLNR": null,
      "TCODE": "MIGO",
      "DocItem": [{
        "MATNR": "10116152801",
        "WERKS": "7855",
        "LGORT": "W007",
        "CHARG": "2214DD",
        "BWART": "541",
        "SOBKZ": null,
        "ERFMG": "3000",
        "ERFME": "EA",
        "EBELN": "0458018717",
        "EBELP": "00010",
        "UMWRK": "7855",
        "UMLGO": "W007",
        "UMCHA": "2214DD",
        "GRUND": null,
        "MHDAT": "20220802",
        "VFDAT": "20250802",
        "KOSTL": null,
        "POSNR": "00010",
        "VBELN": null,
        "SGTXT": null
      }]
    }
  }
}

3.4 WMS to SAP: Inventory count 4197 Stock count results to SAP

Request Interface: /stockCountResult
Interface Description: WMS Inventory count
Request Type HTTP POST

Request Parameter Description

Request Parameter Example

{
  "MT_SCH_WMS_StockCountResult": {
    "FileName": "4000004197_7855_20221223104943560_2129.xml",
    "DocHead": {
      "IBLNR": "0100017539",
      "GJAHR": "2022",
      "DZLDAT": "20221219104943",
      "DocItem": [{
        "DZEILE": "1",
        "MATNR": "15141410101CN",
        "CHARG": "2510",
        "ERFMG": "3000",
        "ERFME": "EA",
        "XNULL": null
      }]
    }
  }
}

3.5 WMS to SAP: Inventory verification 4048 Stock on hand to SAP

Request Interface: /stockBalance
Interface Description: WMS Inventory verification
Request Type HTTP POST

Request Parameter Description

Request Parameter Example

{
  "MT_SCH_WMS_StockBalance": {
    "FileName": "4000004048_7855_20221212040109686_2083.xml",
    "RPHead": {
      "Reference": "7855121204010984",
      "ERSDA": "20221212",
      "CPUTM": "040109",
      "RPItem": [
        {
          "MATNR": "10110446201CN",
          "WERKS": "7855",
          "LGORT": "W007",
          "CHARG": "2410",
          "VFDAT": "20220930",
          "MEINS": "EA",
          "CLABS": "42",
          "STATUS": "Unrestricted"
        },
        {
          "MATNR": "10110446201CN",
          "WERKS": "7855",
          "LGORT": "W007",
          "CHARG": "2509",
          "VFDAT": "20230901",
          "MEINS": "EA",
          "CLABS": "58038",
          "STATUS": "Unrestricted"
        },
        {
          "MATNR": "10110446201CN",
          "WERKS": "7855",
          "LGORT": "W007",
          "CHARG": "2709",
          "VFDAT": "20250831",
          "MEINS": "EA",
          "CLABS": "38080",
          "STATUS": "Unrestricted"
        }
      ]
    }
  }
}

3.6 WMS to SAP: Outsourcing 4064 GR for Subcontract PO

Request Interface: /GRforSubconPO
Interface Description: WMS Outsourcing
Request Type HTTP POST

Request Parameter Description

Request Parameter Example

{
  "MT_SCH_WMS_GRforSubconPO": {
    "FileName": "4000004064_7855_20221222100014966_2120.xml",
    "POGR": {
      "BUDAT": "20221222",
      "BLDAT": "20221222",
      "HEADER_TXT": null,
      "GRGI_NO": null,
      "BILL_OF_LADING": null,
      "GM_CODE": "01",
      "Item": [
        {
          "MATNR": "10116152801",
          "WERKS": "7855",
          "LGORT": "W007",
          "ERFMG": "960",
          "ERFME": "EA",
          "CHARG": "2194QD",
          "VFDAT": "20250713",
          "MHDAT": "20220713",
          "BWART": "543",
          "SPEC_STOCK": "O",
          "MVT_IND": null,
          "EBELN": "0458029926",
          "EBELP": "00010",
          "LIFNR": "2100003636",
          "LINE_ID": null,
          "HIPOS": "00010",
          "SGTXT": null
        },
        {
          "MATNR": "10116152801",
          "WERKS": "7855",
          "LGORT": "W007",
          "ERFMG": "42",
          "ERFME": "EA",
          "CHARG": "2200SD",
          "VFDAT": "20250719",
          "MHDAT": "20220719",
          "BWART": "543",
          "SPEC_STOCK": "O",
          "MVT_IND": null,
          "EBELN": "0458029926",
          "EBELP": "00010",
          "LIFNR": "2100003636",
          "LINE_ID": null,
          "HIPOS": "00020",
          "SGTXT": null
        },
        {
          "MATNR": "10116152801CN",
          "WERKS": "7855",
          "LGORT": "W007",
          "ERFMG": "960",
          "ERFME": "EA",
          "CHARG": "2194QD",
          "VFDAT": "20250713",
          "MHDAT": "20220713",
          "BWART": "101",
          "SPEC_STOCK": null,
          "MVT_IND": "B",
          "EBELN": "0458029926",
          "EBELP": "00010",
          "LIFNR": "2100003636",
          "LINE_ID": "00010",
          "HIPOS": null,
          "SGTXT": null
        },
        {
          "MATNR": "10116152801CN",
          "WERKS": "7855",
          "LGORT": "W007",
          "ERFMG": "42",
          "ERFME": "EA",
          "CHARG": "2200SD",
          "VFDAT": "20250719",
          "MHDAT": "20220719",
          "BWART": "101",
          "SPEC_STOCK": null,
          "MVT_IND": "B",
          "EBELN": "0458029926",
          "EBELP": "00010",
          "LIFNR": "2100003636",
          "LINE_ID": "00020",
          "HIPOS": null,
          "SGTXT": null
        }
      ]
    }
  }
}

3.7 WMS to SAP: 对3919数据由WMS传输至SAP 3919 POD

Request Interface: /pod
Interface Description: WMS 对3919数据由WMS传输至SAP
Request Type HTTP POST

Request Parameter Description

Request Parameter Example

{
  "MT_SCH_WMS_POD": {
    "FileName": "4000003919_7857_20221226-190211-480.XML",
    "PODHead": {
      "ProofDate": "20221215",
      "ProofTime": "023502",
      "VBELN": "4402842948",
      "PODItem": [
        {
          "POSNR": "000010",
          "AdmQnty": "4",
          "MATNR": "10215283803CN",
          "ORKTX": "怡丽丝尔 优悦活颜 柔滑弹润水(滋润型)",
          "CHARG": "2507"
        },
        {
          "POSNR": "000020",
          "AdmQnty": "4",
          "MATNR": "10215282803CN",
          "ORKTX": "怡丽丝尔 优悦活颜 柔滑弹润水(清爽型)",
          "CHARG": "2506"
        },
        {
          "POSNR": "000030",
          "AdmQnty": "4",
          "MATNR": "10115229801CN",
          "ORKTX": "怡丽丝尔 优悦活颜 柔滑防护精华乳 SPF50+ PA++++",
          "CHARG": "2410"
        },
        {
          "POSNR": "000040",
          "AdmQnty": "4",
          "MATNR": "10116858801CN",
          "ORKTX": "怡丽丝尔 蕴能凝时 三重防护隔离乳",
          "CHARG": "2406",
          "Variance": {
            "GRUND": "DFG2",
            "LFIMG_DIFF": "1",
            "VRKME": "EA",
            "PODMG": "3"
          }
        },
        {
          "POSNR": "000050",
          "AdmQnty": "4",
          "MATNR": "10118888801CN",
          "ORKTX": "怡丽丝尔 纯肌净白 集中淡斑精华液",
          "CHARG": "2408"
        },
        {
          "POSNR": "000060",
          "AdmQnty": "4",
          "MATNR": "10118350801CN",
          "ORKTX": "怡丽丝尔 优悦活颜 眼唇抚纹遮瑕精华霜",
          "CHARG": "2409"
        }
      ]
    }
  }
}

3.8 SAP to WMS: Purchasing (transfer from warehouse) 4060 Inbound Delivery

Request Interface: /inboundDelivery
Interface Description: SAP Purchasing (transfer from warehouse)
Request Type HTTP POST

Request Parameter Description

Request Parameter Example

{
  "MT_SCH_WMS_InboundDelivery": {
    "FileName": "4000004060_7855_20230110182029_67fecf8d90d011ed9b12000006277758.xml",
    "IBDHead": {
      "InStcNo": "4100702874",
      "AUART": "Z4EL",
      "AdmYMD": "20230101",
      "SAP_VENDORCODE": "0A10000001",
      "SAP_VENDORNAME": "SHISEIDO CO., LTD.",
      "SAP_COUNTRY": "JP",
      "BOLNR": "785C253/22",
      "InvoiceNo": "785C253/22",
      "IBDItem": [
        {
          "COSNR": "000010",
          "SAPPRODUCTCD": "1018X192000",
          "DESCRIBE": "JGA.AN PUV SS SC MILK A PP 4ML",
          "CHARG": "COMMON",
          "PLACECD": "7855",
          "LGORT": "W007",
          "InQnty": "1320000.000",
          "VRKME": "EA",
          "BELNR": "4570015393",
          "VGPOS": "000030",
          "BWART": "109"
        },
        {
          "COSNR": "000020",
          "SAPPRODUCTCD": "1018Y734000",
          "DESCRIBE": "JGA.AN DAY SERUM 6ML",
          "CHARG": "COMMON",
          "PLACECD": "7855",
          "LGORT": "W007",
          "InQnty": "470000.000",
          "VRKME": "EA",
          "BELNR": "4570015393",
          "VGPOS": "000040",
          "BWART": "109"
        }
      ]
    }
  }
}

3.9 SAP to WMS: Withdrawal (removal from the warehouse) 4062 Outbound Delivery

Request Interface: /outboundDelivery
Interface Description: SAP Withdrawal (removal from the warehouse)
Request Type HTTP POST

Request Parameter Description

Request Parameter Example

{
  "MT_SCH_WMS_OutboundDelivery": {
    "FileName": "4000004062_7855_20230106121020_08e4c7fb8d7811ed9d34000006ab72d7.xml",
    "OBDHead": {
      "OutStcNo": "4500085836",
      "ShippingCondition": "01",
      "AUART": "Z4NL",
      "AdmYMD": "20230106",
      "QUALF": "006",
      "QUALIFIER": "ORI",
      "SAP_LOCATION1": "3F-8F LJZ FINANCIAL PLAZA",
      "SAP_PARVW_D": "WE",
      "DELIVERADDCD": "0A78500001",
      "DELIVERADDNM": "Shiseido China Co., Ltd.",
      "DELIVERADD1": "3F-8F LJZ FINANCIAL PLAZA",
      "DELIVERADD2": "826 CENTURY AVENUE",
      "AREANM_D": "SHANGHAI",
      "SAP_POSTCD_D": "200120",
      "SAP_COUNTRY_D": "CN",
      "SAP_SALESORGANIZATION_D": "7851",
      "SAP_SALESORGANIZATION_P": "7851",
      "OUTPUTTYPE": "Z4OD",
      "OBDItem": [
        {
          "LineNo": "000010",
          "SAPPRODUCTCD": "15142520101CN",
          "PLACECD": "7855",
          "ActualQty": "1002.000",
          "LGORT": "W001",
          "VRKME": "EA",
          "SAP_DISTRIBUTIONCHANNEL": "16",
          "PSTYV": "NLN",
          "MoveType": "641"
        },
        {
          "LineNo": "000020",
          "SAPPRODUCTCD": "15143117101CN",
          "PLACECD": "7855",
          "ActualQty": "1634.000",
          "LGORT": "W001",
          "VRKME": "EA",
          "SAP_DISTRIBUTIONCHANNEL": "16",
          "PSTYV": "NLN",
          "MoveType": "641"
        },
        {
          "LineNo": "000030",
          "SAPPRODUCTCD": "15143315101CN",
          "PLACECD": "7855",
          "ActualQty": "5001.000",
          "LGORT": "W001",
          "VRKME": "EA",
          "SAP_DISTRIBUTIONCHANNEL": "16",
          "PSTYV": "NLN",
          "MoveType": "641"
        },
        {
          "LineNo": "000040",
          "SAPPRODUCTCD": "15143316101CN",
          "PLACECD": "7855",
          "ActualQty": "2001.000",
          "LGORT": "W001",
          "VRKME": "EA",
          "SAP_DISTRIBUTIONCHANNEL": "16",
          "PSTYV": "NLN",
          "MoveType": "641"
        },
        {
          "LineNo": "000050",
          "SAPPRODUCTCD": "15143374101CN",
          "PLACECD": "7855",
          "ActualQty": "1000.000",
          "LGORT": "W001",
          "VRKME": "EA",
          "SAP_DISTRIBUTIONCHANNEL": "16",
          "PSTYV": "NLN",
          "MoveType": "641"
        }
      ]
    }
  }
}

3.10 SAP to WMS: Inventory count 4196 Stock count document

Request Interface: /stockDocument
Interface Description: SAP Inventory count
Request Type HTTP POST

Request Parameter Description

Request Parameter Example

{
  "MT_SCH_WMS_StockCountDocument": {
    "FileName": "4000004196_7857_20230206092551_319899cda5bd11ed8897000006277757.xml",
    "DocHead": {
      "StcDoc": "0100018595",
      "FiscalYear": "2023",
      "CALDATE": "20230206",
      "PlaceCD": "7857",
      "LGORT": "W999",
      "DocItem": [
        {
          "LineNo": "001",
          "SAPPRODUCTCD": "34501753101CN",
          "CHARG": "2252",
          "MEINS": "EA",
          "StockType": "1",
          "DESCRIBE": "TOA TOA LRSP_PRESSE SHADE1"
        },
        {
          "LineNo": "002",
          "SAPPRODUCTCD": "34501613101CN",
          "CHARG": "2243SG",
          "MEINS": "EA",
          "StockType": "1",
          "DESCRIBE": "GWP INAPROP RED TOA SHADE1"
        },
        {
          "LineNo": "003",
          "SAPPRODUCTCD": "85066100102CN",
          "CHARG": "2230K9",
          "MEINS": "EA",
          "StockType": "1",
          "DESCRIBE": "NR FHPM EDP-20-(x12) SOFIX 0,8ML"
        },
        {
          "LineNo": "004",
          "SAPPRODUCTCD": "1018X191000CN",
          "CHARG": "2221ED",
          "MEINS": "EA",
          "StockType": "1",
          "DESCRIBE": "JGA.AN PUV SS SC MILK A 12ML"
        }
      ]
    }
  }
}

3.11 SAP to WMS: Outsourcing 4050 Subcontract PO

Request Interface: /subcontractPO
Interface Description: SAP Outsourcing
Request Type HTTP POST

Request Parameter Description

Request Parameter Example

{
    "MT_SCH_WMS_SubcontractPO": {
        "FileName": "4000004050_7855_20220725153700_91ae73a00bec11ed894500000078ed3a.xml",
        "POHead": {
            "InvoiceNo": "0458014623",
            "CompanyCD": "785",
            "BSART": "Z410",
            "AEDAT": "20220721",
            "PARTN": "2100000713",
            "EKORG": "2001",
            "ORGID": "253",
            "CURCY": "CNY",
            "DocumentDate": "20220721",
            "POItem": [
                {
                    "VGPOS": "00010",
                    "ItemCategory": "3",
                    "HEADERPRODUCTCD": "34101225101CN",
                    "ShortText": "NARS 亮采柔滑遮瑕膏 奶咖色",
                    "PlaceCd": "7855",
                    "LGORT": "W007",
                    "ImportQnty": "1000.000",
                    "MENEE": "EA",
                    "PriceUnit": "1",
                    "EAN11": "607845012252",
                    "Component": {
                        "HIPOS": "00010",
                        "POSNR": "0001",
                        "ITEMPRODUCTCD": "34101225101",
                        "RequireQnty": "      1000.000",
                        "MEINS": "EA",
                        "SHKZG": "H"
                    }
                },
                {
                    "VGPOS": "00020",
                    "ItemCategory": "3",
                    "HEADERPRODUCTCD": "34170828102CN",
                    "PlaceCd": "7855",
                    "LGORT": "W007",
                    "ImportQnty": "1000.000",
                    "MENEE": "EA",
                    "PriceUnit": "1",
                    "EAN11": "607845708285",
                    "Component": {
                        "HIPOS": "00020",
                        "POSNR": "0001",
                        "ITEMPRODUCTCD": "34170828102",
                        "RequireQnty": "      1000.000",
                        "MEINS": "EA",
                        "SHKZG": "H"
                    }
                }
            ]
        }
    }
}

3.12 SAP to WMS: 4052 Batch Master Data

Request Interface: /batch
Interface Description: SAP Batch master data from S4 to 3PL WMS.
Request Type HTTP POST

Request Parameter Example

{
  "MT_SCH_WMS_BatchMaster": {
    "FileName": "4000004052_7855_20221209164328_8d47b563779d11edb29b00000078ed3a.xml",
    "BatchMaster": [{
      "SAPPRODUCTCD": "10115234801CN",
      "PlaceCD": "7855",
      "CHARG": "2503",
      "EXPIRYDATE": "20250301",
      "PRODDATE": "20220301",
      "AvailableDate": "20221001"
    }]
  }
}

3.13 SAP to WMS: Internal storage 4054 Stock Movement Outbound

Request Interface: /stockMovement
Interface Description: SAP Internal storage
Request Type HTTP POST

Request Parameter Example

{
  "MT_SCH_WMS_StockMovementOutbound": {
    "FileName": "4000004054_7855_20230627142420_4033b81a14b311eebdf8000006ab72d8.xml",
    "DocHead": {
      "DocDate": "20230627",
      "PostingDate": "20230627",
      "CreateDate": "20230627",
      "CreateTime": "022417",
      "ProDoc": "5002838448",
      "ProDocYear": "2023",
      "DocItem": [
        {
          "Lineno": "0001",
          "SAPPRODUCTCD": "15143244101CN",
          "Qnty": "87.000 ",
          "ERFME": "EA",
          "Placecd": "7855",
          "LGORT": "W005",
          "CHARG": "1175L1",
          "MoveType": "343"
        },
        {
          "Lineno": "0003",
          "SAPPRODUCTCD": "15143244101CN",
          "Qnty": "19.000 ",
          "ERFME": "EA",
          "Placecd": "7855",
          "LGORT": "W005",
          "CHARG": "1176M1",
          "MoveType": "343"
        },
        {
          "Lineno": "0005",
          "SAPPRODUCTCD": "15143244101CN",
          "Qnty": "160.000 ",
          "ERFME": "EA",
          "Placecd": "7855",
          "LGORT": "W005",
          "CHARG": "1190R1",
          "MoveType": "343"
        },
        {
          "Lineno": "0007",
          "SAPPRODUCTCD": "15143244101CN",
          "Qnty": "118.000 ",
          "ERFME": "EA",
          "Placecd": "7855",
          "LGORT": "W005",
          "CHARG": "1193T1",
          "MoveType": "343"
        },
        {
          "Lineno": "0009",
          "SAPPRODUCTCD": "15143244101CN",
          "Qnty": "161.000 ",
          "ERFME": "EA",
          "Placecd": "7855",
          "LGORT": "W005",
          "CHARG": "1257G1",
          "MoveType": "343"
        },
        {
          "Lineno": "0011",
          "SAPPRODUCTCD": "15143244101CN",
          "Qnty": "213.000 ",
          "ERFME": "EA",
          "Placecd": "7855",
          "LGORT": "W005",
          "CHARG": "1330M1",
          "MoveType": "343"
        },
        {
          "Lineno": "0013",
          "SAPPRODUCTCD": "15143244101CN",
          "Qnty": "43.000 ",
          "ERFME": "EA",
          "Placecd": "7855",
          "LGORT": "W005",
          "CHARG": "1333N1",
          "MoveType": "343"
        },
        {
          "Lineno": "0015",
          "SAPPRODUCTCD": "15143244101CN",
          "Qnty": "39.000 ",
          "ERFME": "EA",
          "Placecd": "7855",
          "LGORT": "W005",
          "CHARG": "1350P1",
          "MoveType": "343"
        },
        {
          "Lineno": "0017",
          "SAPPRODUCTCD": "15143244101CN",
          "Qnty": "7.000 ",
          "ERFME": "EA",
          "Placecd": "7855",
          "LGORT": "W005",
          "CHARG": "1351Q1",
          "MoveType": "343"
        }
      ]
    }
  }
}

4.Interface Return Explanation

4.1 Normal return

{
    "status": "success"
}

4.2 Abnormal return

{
    "status": "false",
    "message": "error description"
}